home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / relnotes / sitemgr / ch2.z / ch2
Encoding:
Text File  |  1997-08-01  |  20.9 KB  |  394 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        2.1  _S_i_t_e_M_g_r__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        SiteMgr includes these subsystems:
  18.  
  19.        _s_i_t_e_m_g_r._b_o_o_k_s._S_i_t_e_M_g_r__U_G      SiteMgr User's Guide
  20.  
  21.        _s_i_t_e_m_g_r._m_a_n._m_a_n_p_a_g_e_s          SiteMgr Man Pages
  22.  
  23.        _s_i_t_e_m_g_r._m_a_n._r_e_l_n_o_t_e_s          SiteMgr Release Notes
  24.  
  25.        _s_i_t_e_m_g_r._s_w._b_a_s_e               SiteMgr Base Software
  26.  
  27.        _s_i_t_e_m_g_r._s_w._c_l_i_e_n_t             SiteMgr Client Software
  28.  
  29.        _s_i_t_e_m_g_r._s_w._s_e_r_v_e_r             SiteMgr Server Extensions
  30.                                      Software
  31.  
  32.  
  33.        2.2  _S_i_t_e_M_g_r__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  34.  
  35.        This section lists the subsystems (and their sizes) of
  36.        SiteMgr.
  37.  
  38.        If you are installing this product for the first time, the
  39.        subsystems marked ``default'' are the ones that are
  40.        installed if you use the ``go'' menu item.  To install a
  41.        different set of subsystems, use the ``install,''
  42.        ``remove,'' ``keep,'' and ``step'' commands in _i_n_s_t to
  43.        customize the list of subsystems to be installed, then
  44.        select the ``go'' menu item.
  45.  
  46.        Note:  The listed subsystem sizes are approximate. Refer to
  47.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  48.               on finding exact sizes.
  49.  
  50.        Subsystem Name                       Subsystem Size
  51.                                             (Kilobytes)
  52.        _s_i_t_e_m_g_r._b_o_o_k_s._S_i_t_e_M_g_r__U_G (default)         721
  53.        _s_i_t_e_m_g_r._m_a_n._m_a_n_p_a_g_e_s (default)               6
  54.        _s_i_t_e_m_g_r._m_a_n._r_e_l_n_o_t_e_s (default)              22
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                   - 2 -
  69.  
  70.  
  71.  
  72.        _s_i_t_e_m_g_r._s_w._b_a_s_e (default)                  173
  73.        _s_i_t_e_m_g_r._s_w._c_l_i_e_n_t (default)               2273
  74.        _s_i_t_e_m_g_r._s_w._s_e_r_v_e_r                          718
  75.  
  76.  
  77.  
  78.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  79.  
  80.        All of the subsystems for SiteMgr can be installed using
  81.        IRIX.  You do not need to use the miniroot. Refer to the
  82.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  83.        instructions.
  84.  
  85.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  86.  
  87.        _s_i_t_e_m_g_r._s_w._c_l_i_e_n_t requires that _w_e_b_v_i_e_w_e_r._s_w._e_o_e and
  88.        _w_e_b_s_u_p_p_o_r_t__e_o_e._s_w._l_i_b (version 1.2 or greater), are
  89.        installed. _w_e_b_v_i_e_w_e_r._s_w._e_o_e requires _i_f_l__e_o_e._s_w._c++, version
  90.        1.1 or greater, to be installed as well.
  91.        _w_e_b_s_u_p_p_o_r_t__e_o_e._s_w._l_i_b requires a _m_i_m_e._t_y_p_e_s file be
  92.        installed in or linked to /_u_s_r/_l_o_c_a_l/_l_i_b/_n_e_t_s_c_a_p_e.
  93.  
  94.        _s_i_t_e_m_g_r._s_w._s_e_r_v_e_r requires that _w_e_b_s_u_p_p_o_r_t__e_o_e._s_w._l_i_b
  95.        (version 1.2 or greater) be installed. Also, if you are
  96.        running a Netscape Fasttrack Personal Server, version 2.0P
  97.        (_n_s__f_a_s_t_t_r_a_c_k) or earlier, and intend to utilize the SiteMgr
  98.        Server Extensions in conjunction with that server, you
  99.        should upgrade to (at least) version 2.01 (of _n_s__f_a_s_t_t_r_a_c_k).
  100.        In earlier versions of this server there were problems
  101.        handling CGI (Common Gateway Interface) processes which
  102.        could cause the SiteMgr client to get into a "hung" state.
  103.        Version 2.01 can be found on the IRIX Applications CD,
  104.        August 1997.
  105.  
  106.  
  107.        If you will be using version control in SiteMgr, you will
  108.        need to install _e_o_e._s_w._r_c_s (the Revision Control System
  109.        Utilities), if this subsystem is not already installed on
  110.        the server machine.
  111.  
  112.  
  113.        2.5  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  114.  
  115.        2.5.1  _E_n_a_b_l_i_n_g__a__H_T_T_P__S_e_r_v_e_r__F_o_r__S_i_t_e_M_g_r
  116.  
  117.        To enable your web site for use with SiteMgr, the server
  118.        software must be installed. Follow this procedure in
  119.        inst(1M) on your server machine:
  120.  
  121.                IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ssssiiiitttteeeemmmmggggrrrr....sssswwww....bbbbaaaasssseeee
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                   - 3 -
  134.  
  135.  
  136.  
  137.                IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll ssssiiiitttteeeemmmmggggrrrr....sssswwww....sssseeeerrrrvvvveeeerrrr
  138.  
  139.        After installation, the SiteMgr client can now communicate
  140.        via HTTP with three CGI (Common Gateway Interface)
  141.        processes. By default, links are created from these
  142.        processes into the default CGI directory, /_v_a_r/_w_w_w/_c_g_i-_b_i_n.
  143.        If your HTTP server initiates CGI processes from some other
  144.        directory, you need to create these links manually:
  145.  
  146.                #### ccccdddd <<<<ddddeeeeffffaaaauuuulllltttt____HHHHTTTTTTTTPPPP____sssseeeerrrrvvvveeeerrrr____CCCCGGGGIIII____ddddiiiirrrreeeeccccttttoooorrrryyyy>>>>
  147.                #### llllnnnn ----ssss ////uuuussssrrrr////ssssiiiitttteeeemmmmggggrrrr////bbbbiiiinnnn////ssssiiiitttteeeemmmmggggrrrr....ccccggggiiii  ....
  148.                #### llllnnnn ----ssss ////uuuussssrrrr////ssssiiiitttteeeemmmmggggrrrr////bbbbiiiinnnn////ssssiiiitttteeeessssttttaaaatttt....ccccggggiiii ....
  149.                #### llllnnnn ----ssss ////uuuussssrrrr////ssssiiiitttteeeemmmmggggrrrr////bbbbiiiinnnn////ssssmmmmddddbbbbffff....ccccggggiiii    ....
  150.  
  151.        At this point, you should be able to communicate with these
  152.        processes utilizing the SiteMgr client (_s_i_t_e_m_g_r(1)). A
  153.        database will be created automatically for you on the HTTP
  154.        server instance which will monitor your web site documents
  155.        and apply revision control, if so desired.
  156.  
  157.  
  158.        _N_O_T_E:  We _s_t_r_o_n_g_l_y _r_e_c_o_m_m_e_n_d that you provide a secure
  159.               server environment for SiteMgr.  We advise you to
  160.               carefully read over the next section, "Security and
  161.               SiteMgr".  It is important to note that after the
  162.               database is initialized, anyone with Web access to
  163.               the SiteMgr http server can write to your site. It is
  164.               _s_t_r_o_n_g_l_y _r_e_c_o_m_m_e_n_d_e_d that you  configure that
  165.               server's authorization features so that password
  166.               protection and/or domain restrictions apply.
  167.  
  168.  
  169.        2.5.2  _S_e_c_u_r_i_t_y__a_n_d__S_i_t_e_M_g_r
  170.  
  171.        Because the SiteMgr CGI process(es) can be used to publish
  172.        documents, remove documents, etc.; we _s_t_r_o_n_g_l_y _r_e_c_o_m_m_e_n_d
  173.        that you provide a secure server environment for SiteMgr to
  174.        run in.
  175.  
  176.        To fully utilize SiteMgr for publishing, your HTTP server
  177.        must be run under a user id that can perform such operations
  178.        (modifying, removing, etc.)  on your web site files, under
  179.        the document root that is being administered by SiteMgr.
  180.        Refer to your HTTP server configuration files to see if this
  181.        is being done.
  182.  
  183.        For example, your server can be changed to run as user
  184.        _s_g_i_w_e_b instead of _n_o_b_o_d_y. The permissions of the files in
  185.        your document root must allow write access for user _s_g_i_w_e_b.
  186.        This could done by making _s_g_i_w_e_b the owner of those files or
  187.        by making the files group-writable and ensuring that _s_g_i_w_e_b
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                   - 4 -
  200.  
  201.  
  202.  
  203.        is in the correct group.
  204.  
  205.        You may also wish to create a unique HTTP server instance
  206.        (different port) to access the SiteMgr CGI process(es). That
  207.        instance could be run under a user id that can perform the
  208.        aforementioned operations.
  209.  
  210.        Another option, utilizing this same methodology, is to only
  211.        invoke/start this server when needed, rather than keeping it
  212.        constantly running.
  213.  
  214.        It is also strongly recommended (but not required) to use
  215.        your HTTP server's authorization feature to apply a password
  216.        and user combination onto both SiteMgr CGI process(es).
  217.        Refer to your server documentation as to how to set this up.
  218.        As an example, for a Netscape(c) server, the following steps
  219.        can be performed:
  220.  
  221.           +o Run the Netscape(c) HTTP Admin Server, connect via
  222.             standard browser.
  223.  
  224.           +o Create two user/password authentication databases, each
  225.             with a unique password and user combination. You may
  226.             wish to create two, since the database creation/update
  227.             CGI (_s_m_d_b_f._c_g_i(1)), which is not run as often, may have
  228.             a higher level of restriction/security assigned to it
  229.             than the standard SiteMgr CGI's (_s_i_t_e_m_g_r._c_g_i(1) and
  230.             _s_i_t_e_s_t_a_t._c_g_i(1)).
  231.  
  232.           +o Modify the HTTP server instance configuration file,
  233.             _o_b_j._c_o_n_f and add the following (provided as example
  234.             only; modify paths, etc. for your environment) lines:
  235.  
  236.             <<<<OOOObbbbjjjjeeeecccctttt ppppppppaaaatttthhhh====""""////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn////ssssiiiitttteeeemmmmggggrrrr....****"""">>>>
  237.             AAAAuuuutttthhhhTTTTrrrraaaannnnssss ffffnnnn====""""bbbbaaaassssiiiicccc----nnnnccccssssaaaa"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc"""" ddddbbbbmmmm====""""////uuuussssrrrr////nnnnssss----hhhhoooommmmeeee////uuuusssseeeerrrrddddbbbb////SSSSiiiitttteeeeMMMMggggrrrr""""
  238.             PPPPaaaatttthhhhCCCChhhheeeecccckkkk ffffnnnn====""""rrrreeeeqqqquuuuiiiirrrreeee----aaaauuuutttthhhh"""" rrrreeeeaaaallllmmmm====""""ssssmmmmCCCCGGGGIIII"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc""""
  239.             <<<<////OOOObbbbjjjjeeeecccctttt>>>>
  240.  
  241.             <<<<OOOObbbbjjjjeeeecccctttt ppppppppaaaatttthhhh====""""////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn////ssssmmmmddddbbbbffff....****"""">>>>
  242.             AAAAuuuutttthhhhTTTTrrrraaaannnnssss ffffnnnn====""""bbbbaaaassssiiiicccc----nnnnccccssssaaaa"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc"""" ddddbbbbmmmm====""""////uuuussssrrrr////nnnnssss----hhhhoooommmmeeee////uuuusssseeeerrrrddddbbbb////SSSSiiiitttteeeeMMMMggggrrrr""""
  243.             PPPPaaaatttthhhhCCCChhhheeeecccckkkk ffffnnnn====""""rrrreeeeqqqquuuuiiiirrrreeee----aaaauuuutttthhhh"""" rrrreeeeaaaallllmmmm====""""ssssmmmmddddbbbbCCCCGGGGIIII"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc""""
  244.             <<<<////OOOObbbbjjjjeeeecccctttt>>>>
  245.  
  246.             <<<<OOOObbbbjjjjeeeecccctttt ppppppppaaaatttthhhh====""""////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn////ssssiiiitttteeeessssttttaaaatttt....****"""">>>>
  247.             AAAAuuuutttthhhhTTTTrrrraaaannnnssss ffffnnnn====""""bbbbaaaassssiiiicccc----nnnnccccssssaaaa"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc"""" ddddbbbbmmmm====""""////uuuussssrrrr////nnnnssss----hhhhoooommmmeeee////uuuusssseeeerrrrddddbbbb////SSSSiiiitttteeeeMMMMggggrrrr""""
  248.             PPPPaaaatttthhhhCCCChhhheeeecccckkkk ffffnnnn====""""rrrreeeeqqqquuuuiiiirrrreeee----aaaauuuutttthhhh"""" rrrreeeeaaaallllmmmm====""""ssssmmmmCCCCGGGGIIII"""" aaaauuuutttthhhh----ttttyyyyppppeeee====""""bbbbaaaassssiiiicccc""""
  249.             <<<<////OOOObbbbjjjjeeeecccctttt>>>>
  250.  
  251.           +o Optionally, if you wish to deny access to the
  252.             underlying RCS directories and files (when using
  253.             version control in SiteMgr), add the following lines
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                   - 5 -
  266.  
  267.  
  268.  
  269.             (to the same file, _o_b_j._c_o_n_f):
  270.  
  271.             <<<<OOOObbbbjjjjeeeecccctttt ppppppppaaaatttthhhh====""""****////RRRRCCCCSSSS////****"""">>>>
  272.             PPPPaaaatttthhhhCCCChhhheeeecccckkkk ffffnnnn====ddddeeeennnnyyyy----eeeexxxxiiiisssstttteeeennnncccceeee
  273.             SSSSeeeerrrrvvvviiiicccceeee ffffnnnn====sssseeeerrrrvvvveeeerrrr----rrrreeeettttrrrriiiieeeevvvveeee
  274.             <<<<////OOOObbbbjjjjeeeecccctttt>>>>
  275.  
  276.             If you are using a NCSA 1.5.x or Apache 1.x server, put
  277.             this in conf/access.conf to achieve the same result:
  278.  
  279.             <<<<DDDDiiiirrrreeeeccccttttoooorrrryyyy ////****////RRRRCCCCSSSS////****>>>>
  280.             <<<<LLLLiiiimmmmiiiitttt GGGGEEEETTTT PPPPUUUUTTTT PPPPOOOOSSSSTTTT>>>>
  281.             oooorrrrddddeeeerrrr aaaalllllllloooowwww,,,,ddddeeeennnnyyyy
  282.             ddddeeeennnnyyyy ffffrrrroooommmm aaaallllllll
  283.             <<<<////LLLLiiiimmmmiiiitttt>>>>
  284.             <<<<////DDDDiiiirrrreeeeccccttttoooorrrryyyy>>>>
  285.  
  286.           +o Restart your HTTP server instance.
  287.  
  288.  
  289.        2.5.3  _L_o_g__A_n_a_l_y_s_i_s__v_i_a__S_i_t_e_M_g_r
  290.  
  291.        To fully utilize SiteMgr's log analysis features, you may
  292.        need to modify your HTTP server's logging configuration
  293.        variables.
  294.  
  295.  
  296.           +o For a NCSA 1.5.x or Apache 1.x server, most of the
  297.             available logging directives will work fine with
  298.             SiteMgr.  You should have an entry like one of the
  299.             following in conf/httpd.conf.  SiteMgr prefers the
  300.             "Combined" option.
  301.  
  302.             LLLLooooggggOOOOppppttttiiiioooonnnnssss SSSSeeeeppppaaaarrrraaaatttteeee
  303.             LLLLooooggggOOOOppppttttiiiioooonnnnssss CCCCoooommmmbbbbiiiinnnneeeedddd
  304.             LLLLooooggggOOOOppppttttiiiioooonnnnssss DDDDaaaatttteeee
  305.  
  306.             In particular, the log file format has an impact on
  307.             statistics visualization feature of SiteMgr. If the
  308.             logs are combined, the referrer and the access
  309.             information can be synthesized to graphically show hits
  310.             from one local document to another. If they are
  311.             separated, the origin of a hit cannot be displayed in
  312.             the animated view.
  313.  
  314.           +o For a Netscape 2.x server, use the Netscape Admin
  315.             Server to set the Server Status->Log Preferences
  316.             format.  Select the "Only log" option and check the top
  317.             eight options.  Your form should look like this:
  318.  
  319.             FFFFoooorrrrmmmmaaaatttt::::
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                   - 6 -
  332.  
  333.  
  334.  
  335.             <<<< >>>> UUUUsssseeee CCCCoooommmmmmmmoooonnnn LLLLooooggggffffiiiilllleeee FFFFoooorrrrmmmmaaaatttt
  336.             <<<<xxxx>>>> OOOOnnnnllllyyyy lllloooogggg::::
  337.                 [[[[xxxx]]]] CCCClllliiiieeeennnntttt hhhhoooossssttttnnnnaaaammmmeeee
  338.                 [[[[xxxx]]]] AAAAuuuutttthhhhnnnnttttiiiiccccaaaatttteeee uuuusssseeeerrrr nnnnaaaammmmeeee
  339.                 [[[[xxxx]]]] SSSSyyyysssstttteeeemmmm ddddaaaatttteeee
  340.                 [[[[xxxx]]]] FFFFuuuullllllll rrrreeeeqqqquuuueeeesssstttt
  341.                 [[[[xxxx]]]] SSSSttttaaaattttuuuussss
  342.                 [[[[xxxx]]]] CCCCoooonnnntttteeeennnntttt lllleeeennnnggggtttthhhh
  343.                 [[[[xxxx]]]] HHHHTTTTTTTTPPPP hhhheeeeaaaaddddeeeerrrr,,,, """"rrrreeeeffffeeeerrrreeeerrrr""""
  344.                 [[[[xxxx]]]] HHHHTTTTTTTTPPPP hhhheeeeaaaaddddeeeerrrr,,,, """"uuuusssseeeerrrr----aaaaggggeeeennnntttt""""
  345.                 [[[[ ]]]] MMMMeeeetttthhhhoooodddd
  346.                 [[[[ ]]]] UUUURRRRIIII
  347.                 [[[[ ]]]] QQQQuuuueeeerrrryyyy ssssttttrrrriiiinnnngggg ooooffff tttthhhheeee UUUURRRRIIII
  348.                 [[[[ ]]]] PPPPrrrroooottttooooccccoooollll
  349.  
  350.             If your Netscape Admin Server insists that you rename
  351.             your access log file, you can move the existing access
  352.             log file (while the server is stopped) and then modify
  353.             the log preferences.
  354.  
  355.           +o Restart your HTTP server instance.  Be sure that your
  356.             HTTP server has sufficient file read/write permissions
  357.             to update the log files.
  358.  
  359.           +o You may find it necessary to rename your access log
  360.             file.  Keep in mind that the SiteMgr server looks for a
  361.             file named _a_c_c_e_s_s or _a_c_c_e_s_s__l_o_g in your log directory.
  362.  
  363.  
  364.        2.6  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  365.  
  366.        After the software has been installed, you might want to
  367.        force your shell to re-cache its list of known executables:
  368.  
  369.                %%%% rrrreeeehhhhaaaasssshhhh
  370.  
  371.        You can then execute the SiteMgr client.  It is found in
  372.        /_u_s_r/_s_b_i_n/_s_i_t_e_m_g_r, and can be started from a shell:
  373.  
  374.                %%%% ssssiiiitttteeeemmmmggggrrrr
  375.  
  376.        You can also launch sitemgr by double-clicking on the
  377.        sitemgr icon found in the webtools page of the icon catalog
  378.        or the Find File tool.
  379.  
  380.        The client application process places itself in the
  381.        background by default.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.